home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / PASCAL / 0188.ZIP / QMODEM.DOC < prev    next >
Text File  |  1985-12-24  |  56KB  |  1,226 lines

  1.         Qmodem - Telecommunications Program Version 1.13  Page 1
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                             Qmodem Operations Manual
  15.                                   Version 1.13
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                              The Forbin Project Inc.
  26.                                and John Friel III  
  27.                                 24 December 1985
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.              Copyright (c)  The Forbin Project Inc. and John Friel III
  56.              All rights to Qmodem are reserved by the Forbin Project Inc.   
  57.  
  58.         Qmodem - Telecommunications Program Version 1.13  Page 2
  59.  
  60.  
  61.              Qmodem  is  a  User Supported program.   I am asking  for  a 
  62.         donation   of  $20.00  for its use.    Those that  donate    will 
  63.         receive   published     announcements    for future  updates   to 
  64.         Qmodem   and other  programs written by the Forbin Project  Inc.
  65.  
  66.              Qmodem    may  be  shared  with   other  people  under   one 
  67.         condition;    that there is  NO CHARGE  for the copy(s).   
  68.  
  69.              A special note to Corporations:  Site licensing is available 
  70.         by arrangement with the author.   Do NOT make multiple copies for 
  71.         use  inside your corporation until you contact The Forbin Project 
  72.         Inc.
  73.  
  74.  
  75.                             The Forbin Project Inc.
  76.                             c/o John Friel III
  77.                             715 Walnut Street
  78.                             Cedar Falls, Iowa  50613
  79.  
  80.         Qmodem - Telecommunications Program Version 1.13  Page 3
  81.  
  82.  
  83.                         T A B L E   O F   C O N T E N T S 
  84.  
  85.                                                            Page     
  86.              Description ..................................  5 
  87.              System Requirements ..........................  6
  88.              Starting Qmodem ..............................  7
  89.              
  90.              Commands .....................................  8
  91.  
  92.                   Alt-A     Strip / Replace communication table  9
  93.  
  94.                   Alt-B     Bells and Beeps toggle ............  9
  95.  
  96.                   Alt-C     Clear screen ......................  9
  97.  
  98.                   Alt-D     Dialing directory ................. 10 
  99.                        C)        Clear entry(s) .................. 10
  100.                        D)        Dial an entry ................... 11
  101.                        E)        Revise the Prefix file .......... 12
  102.                        M)        Manual dial a number ............ 13
  103.                        N)        Next page of the directory ...... 13
  104.                        P)        Previous page of the directory .. 13
  105.                        R)        Revise an entry ................. 13
  106.                        X)        Exit back to Qmodem ............. 14
  107.  
  108.                   Alt-E     Echo toggle ....................... 14
  109.  
  110.                   Alt-G     Graphic mode toggle ............... 14
  111.  
  112.                   Alt-H     Hang-up modem ..................... 14
  113.  
  114.                   Alt-I     Information on Qmodem ............. 15
  115.  
  116.                   Alt-J     Function key menu ................. 15
  117.  
  118.                   Alt-L     Log drive ......................... 15
  119.  
  120.                   Alt-O     Sub directory change .............. 15
  121.  
  122.                   Alt-P     Communication parameter menu ...... 16
  123.  
  124.                   Alt-Q     Redial last number ................ 16
  125.  
  126.                   Alt-R     DOS shell ......................... 17
  127.  
  128.                   Alt-S     Split screen toggle ............... 17
  129.  
  130.                   Alt-T     Screen Dump ....................... 17
  131.  
  132.                   Alt-V     View file ......................... 18
  133.  
  134.                   Alt-W     Disk directory and Xmit time ...... 18
  135.  
  136.                   Alt-X     Exit Qmodem ....................... 18
  137.  
  138.         Qmodem - Telecommunications Program Version 1.13  Page 4
  139.  
  140.  
  141.                   Alt-Y     Delete a file ..................... 19
  142.  
  143.                   Alt-Z     Xon / Xoff toggle ................. 19
  144.  
  145.                   PgUp      Upload menu ....................... 20
  146.  
  147.                   PgDn      Download menu ..................... 23
  148.  
  149.                   Up-Arrow  Scroll back screen ................ 24
  150.  
  151.  
  152.              Appendix A
  153.  
  154.                   QINSTALL - Qmodem Installation Program ...... 25
  155.  
  156.              Appendix B
  157.  
  158.                   TURBO Pascal Usage .......................... 26
  159.  
  160.              Appendix C
  161.  
  162.                   Dialing Directory description................ 27
  163.  
  164.              Appendix D
  165.  
  166.                   A note from the Forbin Project Inc. ......... 28
  167.  
  168.         Qmodem - Telecommunications Program Version 1.13  Page 5
  169.  
  170.  
  171.                               D E S C R I P T I O N
  172.  
  173.              Qmodem  is  a modem communications program.   It  can  store 
  174.         many phone numbers in a personal directory for later recall.   It 
  175.         will  handle a variety of modems connected to the PC.    Transfer  
  176.         files  to  other  computers using either XON  /  XOFF    or   the   
  177.         ever  popular  XMODEM  protocols.    The  program    was  written   
  178.         using Turbo Pascal from Borland International.
  179.  
  180.         Qmodem - Telecommunications Program Version 1.13  Page 6
  181.  
  182.  
  183.                       S Y S T E M   R E Q U I R E M E N T S
  184.  
  185.  
  186.              Qmodem  requires  an IBM PC/XT/AT/PCjr or  close  compatible 
  187.         with 192K, a Color/Graphics or Monochrome card and monitor, and a 
  188.         serial port and modem.   
  189.  
  190.              It should be noted here, that Qmodem sometimes does not work 
  191.         on a PC when other background software is running.   I have heard 
  192.         a  few  horror stories where a screen clock routine  caused   all  
  193.         sorts of problems with the serial port.   
  194.  
  195.         Qmodem - Telecommunications Program Version 1.13  Page 7
  196.  
  197.  
  198.                           S T A R T I N G   Q M O D E M
  199.  
  200.              Throughout   the  documentation,   you  may  run  into   the 
  201.         characters [RETURN] and <cr>.   These represent the return key on 
  202.         the keyboard.  If you see these in the text, press the return key 
  203.         rather than typing in the string.
  204.  
  205.              Qmodem   is started by entering  "Qmodem [RETURN]" from  the 
  206.         DOS prompt like the following.
  207.  
  208.                   A>Qmodem [RETURN]
  209.           
  210.              Please read the opening screen carefully.   Press any key to 
  211.         continue on into Qmodem.   At the top of the next screen,  Qmodem 
  212.         displays  the version logo and what  type of display card you are 
  213.         using.  Immediately after the logo,  Qmodem looks  for 6 files on 
  214.         the  disk as follows:      
  215.  
  216.              QMODEM.CNF - the  configuration  file.     
  217.              QMODEM.KEY - the function key file.
  218.              QMODEM.PRE - the dialing prefix file.
  219.              QMODEM.FON - the dialing directory file.
  220.              QMODEM.XLT - the strip / replace table file.
  221.              QMODEM.WND - the window definition file.
  222.  
  223.              If  you  are just starting and do not have the files  listed 
  224.         above,   Qmodem   will  create  most of them  for  you.   Two  of 
  225.         them:  QMODEM.CNF  and  QMODEM.WND  are created by  the  Qinstall 
  226.         program listed in Appendix A (also on you Qmodem Disk).  For  the  
  227.         dialing  directory,   Qmodem   will   initialize   all   of   the  
  228.         communication parameters by asking you 3 or 4 questions.   
  229.  
  230.         Qmodem - Telecommunications Program Version 1.13  Page 8
  231.  
  232.  
  233.                                  C O M M A N D S
  234.  
  235.              There are 29 commands in the Help Menu as follows.
  236.  
  237.                   Alt-A ........ Strip / Replace screen
  238.                   Alt-B ........ Beeps and Bells toggle
  239.                   Alt-C ........ Clear screen 
  240.                   Alt-D ........ Dialing directory 
  241.                   Alt-E ........ Echo toggle
  242.                   Alt-G ........ Graphics mode toggle
  243.                   Alt-H ........ Hang-up modem 
  244.                   Alt-I ........ Information on Qmodem
  245.                   Alt-J ........ Function key menu 
  246.                   Alt-L ........ Log drive
  247.                   Alt-O ........ Sub directory change
  248.                   Alt-P ........ Communication parameter menu 
  249.                   Alt-Q ........ Redial last number 
  250.                   Alt-R ........ DOS shell
  251.                   Alt-S ........ Split screen toggle
  252.                   Alt-T ........ Screen Dump
  253.                   Alt-V ........ View file     
  254.                   Alt-W ........ Disk directory and Xmit time 
  255.                   Alt-X ........ Exit Qmodem
  256.                   Alt-Y ........ Delete a file
  257.                   Alt-Z ........ Xon / Xoff toggle
  258.                   Home ......... Main Menu window
  259.                   PgUp ......... Upload menu 
  260.                   PgDn ......... Download menu 
  261.                   Up-Arrow ..... Scroll back screen 
  262.                   Ctrl-End ..... Sustained BREAK signal
  263.                   Shft-Tab ..... Add Linefeeds toggle
  264.                   Ctrl-PrtSc ... Printer echo toggle
  265.                   Ctrl-Home .... Capture Buffer toggle
  266.  
  267.              All   are   selected  by  pressing  the  corresponding   key 
  268.         combinations on the keyboard. 
  269.  
  270.         Qmodem - Telecommunications Program Version 1.13  Page 9
  271.  
  272.  
  273.              Alt-A  Strip / Replace table.
  274.  
  275.              Pressing  the  Alt-A  key  combinations  produces  a  screen 
  276.         containing  the  ASCII values 0 through 127 and  their  translate 
  277.         equivalents.   Above   the  translate  table  is  the   Character 
  278.         representation  of  the  highlighted  entry,  both  received  and 
  279.         translated.  
  280.          
  281.              If,  Qmodem  has  created the file,  all entries  will  have 
  282.         duplicate   translate  values.    This  is  referred  to  as  "No 
  283.         translation performed". 
  284.              
  285.              To  change  (translate)  an  ASCII  value,   you  move   the 
  286.         highlighted  (semi  box  looking thing)  around  the  table  (up,  
  287.         down,  left,  and  right)   to the number you want to   strip  or 
  288.         replace. The number to the left of the dash is the ASCII position  
  289.         in  the  table.    The  number to the right of the dash   is  the 
  290.         character  you  will see when Qmodem receives the number  on  the   
  291.         left. To change the character from the input, press the Space Bar 
  292.         once.  You  will  receive a prompt at the bottom  of  the  screen  
  293.         asking for an integer between 0 and 255.   To strip the character   
  294.         from   the input,  you need only replace the number on the  right 
  295.         with  a 0 (ZERO).  Press [RETURN] to complete the change.   The S 
  296.         key will swap  the table showing the high bit entries 128  - 255.    
  297.         Repeat the procedure to change any of these also.  When you   are 
  298.         finished,  press  the [Esc] key to save the changes (if any)  and 
  299.         return to Qmodem ready.
  300.  
  301.  
  302.              Alt-B  Bells and Beeps toggle
  303.  
  304.              Qmodem can now be made totally silent.   The Bells and Beeps 
  305.         to signal you that something is different can be very distracting 
  306.         in an office environment.   You can set Qmodem's default state in 
  307.         the  installation program Qinstall,  or toggle it on and off with 
  308.         Alt-B.
  309.  
  310.  
  311.              Alt-C  Clear screen
  312.  
  313.              This  will clear  the screen of all data.    If you  are  in 
  314.         split screen mode, this will only clear the bottom portion of the 
  315.         screen.
  316.             
  317.              In addition to clearing the active screen,  if ANSI graphics 
  318.         mode has been enabled [see Alt-G in this document],  Qmodem  will 
  319.         also  send  the  escape sequences necessary to reset  the  screen 
  320.         colors  you have selected.   For those of you who  call  Bulletin 
  321.         Boards that have those neat color screens,  sometimes, the colors 
  322.         end up different than you would like.  Using Alt-C will reset the 
  323.         color on your screen back to your configuration selections.  
  324.  
  325.              It  should also be noted;  some clone  computers,  like  the 
  326.         Tandy 1000,  use ANSI.SYS for the CLS command from DOS.   You may 
  327.         see  "<-[02J"  when typing CLS.   This means you have  booted  up 
  328.  
  329.         Qmodem - Telecommunications Program Version 1.13  Page 10
  330.  
  331.  
  332.         without  the ANSI.SYS in your CONFIG.SYS file.   You need to  add 
  333.         the following line to your CONFIG.SYS file:
  334.  
  335.                   Device=ANSI.SYS<CR>        <-- <CR> means RETURN key
  336.  
  337.         Make  sure  you have this if you want ANSI graphics or your  Al-C 
  338.         puts funny characters on your screen.
  339.  
  340.  
  341.              Alt-D Dialing directory.
  342.  
  343.              The following is an example of the dialing command prompt at 
  344.         on the screen.
  345.  
  346.  
  347.          * Dial number(s) [ <cr> for Dialing Directory, <Esc> to exit ]
  348.          * 
  349.  
  350.  
  351.              This  is the quick entry prompt.   Here,  you can enter your 
  352.         dialing directory number(s) and skip the dialing directory.   All 
  353.         of  the dialing prefix codes are valid.   For  example,  to  dial 
  354.         directory  number  12,  you would just enter "12<cr>" and  Qmodem 
  355.         will  process the call.  Instructions are given below for dialing 
  356.         up to 10 different numbers in a single command!
  357.  
  358.              With  the use of the optional prefix  codes,  long  distance 
  359.         services   may  be utilized.   Some services require  the  prefix 
  360.         codes before the actual number,  another needs it just at the end 
  361.         of  the  number,   while still others need two  codes  sent  out.  
  362.         Qmodem  can handle all of the above cases with ease.    Refer  to 
  363.         the  dialing  prefix subcommand below for a full explanation   on 
  364.         how to use the prefix codes.
  365.  
  366.             The dialing directory can hold up to 200 names,   numbers and 
  367.         communication   parameters.    This  command  is  also  a   small 
  368.         environment in itself.  From here, you can dial or revise any one 
  369.         of  the  200  numbers,  change any one of the  5  prefix  dialing 
  370.         strings,  enter  a  manual  dial mode or just  page  through  the 
  371.         listing.  There are Nine sub-function as follows:
  372.  
  373.                   C) Clear entry(s)
  374.                   D) Dial an entry
  375.                   E) Revise the Prefix file
  376.                   N) Next page of the directory
  377.                   M) Manual dial a number
  378.                   P) Previous page of the directory
  379.                   R) Revise an entry
  380.                   X) Exit back to Qmodem
  381.                   #) 0 to 9, shows numbered page
  382.  
  383.  
  384.              Clear entry(s)
  385.  
  386.              The  familiar  "Number >" shows up again waiting for you  to 
  387.  
  388.         Qmodem - Telecommunications Program Version 1.13  Page 11
  389.  
  390.  
  391.         enter  a number in the range 1 - 200.   Pressing  [RETURN]  exits 
  392.         back to the dialing option menu.   After entering a number, say 1 
  393.         for  example,  Qmodem  asks "Through >".   Here you can  enter  a 
  394.         larger  number if you want to clear a continuous group  or  press 
  395.         [RETURN] and Qmodem will repeat the first number for you.   Last, 
  396.         Qmodem says "Are you sure ?".  To clear them a 'Y' or 'y' must be 
  397.         entered, anything else and Qmodem aborts the clear command.
  398.  
  399.  
  400.              Dialing an entry
  401.  
  402.              Again,   the  option  side of the screen will clear and  you 
  403.         will see the prompt "Number >".   Now you have two options:  One,  
  404.         you can enter a number in the range 1 - 200 and press enter,   or 
  405.         Two,  you can prefix the number with one of five characters, [ +,  
  406.         -,  !,  @,  and  #].   This will cause  one of the five  optional 
  407.         prefix  strings  to  be tacked on to the phone  number  from  the 
  408.         entry.   The  following  examples show both good and bad  dialing 
  409.         entries:
  410.  
  411.                   Good ==>       Number >+1
  412.                                  Number >#200
  413.                                  Number >123
  414.  
  415.                   Bad ===>       Number >a12  (a is not a valid prefix)
  416.                                  Number >201  (number > 200)
  417.                                  Number >$1   ($ is not a valid prefix)
  418.  
  419.              As I mentioned above,  Qmodem now has the capability to dial 
  420.         up to 10 different numbers at one time!  At either of the dialing 
  421.         prompts  (quick dial or from within the dialing  directory),  you 
  422.         can  specify  up  to 10 different entry  numbers  (complete  with 
  423.         prefix  codes) to be cycled through until a connection  has  been 
  424.         established. 
  425.              
  426.              At  the dial prompt,  you are now allowed to enter up to  70 
  427.         characters that define the entries in the phone book.  An example 
  428.         will be helpful now:
  429.  
  430.                   [(dial prompt)] +1, +12, +123, +!199- 50 51,52,53<cr>
  431.              
  432.              Whew!   That  is a lot of dialing commands!    Here is  what 
  433.         happens  next.    Qmodem   parses  (takes apart)  the  string  of 
  434.         characters  and  places  each dialing  command  into  a  separate 
  435.         holding  area.    There are only 10 such holding areas so  Qmodem 
  436.         will  ignore any  extras.   The characters that tell Qmodem  that 
  437.         this   is  a  new number are the comma "," and the  space   "  ".    
  438.         Commas  and spaces can  be next  to  each  other for  clarity  if  
  439.         you   so choose.     As  in  the example,   the first area   will 
  440.         contain the string "+1".   The second will contain "+12",   third 
  441.         "+123",   fourth "+!199-",   fifth "50", sixth has "51",  seventh 
  442.         holds "52" and the eighth contains "53".  
  443.              
  444.              As  before,    note  that commas  and  spaces  can  be  used 
  445.         together   and   are  ignored  by Qmodem.   When Qmodem  finds  a 
  446.  
  447.         Qmodem - Telecommunications Program Version 1.13  Page 12
  448.  
  449.  
  450.         holding area that has more  that six characters,   it flags it as 
  451.         invalid and goes on to the next one.    Remember,    the  maximum  
  452.         characters  is six for   any  one  dial string!   
  453.  
  454.              Now comes the neat part!   If you enter two or more  entries 
  455.         to dial, Qmodem automatically puts you in Re-Dial mode and starts 
  456.         through  the  list,  one at a time until it makes  a  connection.  
  457.  
  458.              When  Qmodem senses the connection,  it removes  that  entry 
  459.         from the list  so  that when you finish the call,   you can press 
  460.         Alt-Q  to continue with the previously selected numbers.
  461.          
  462.  
  463.              Revise Prefix entries
  464.  
  465.              This is much the same as revising a dialing entry.  A window 
  466.         will  open up near the bottom of the screen showing you all 5  of 
  467.         the prefix entries.   Enter the prefix character that corresponds 
  468.         to the string you want to change or press [RETURN].   To clear an 
  469.         entry, press [SPACE] and then [RETURN].  
  470.  
  471.              As stated earlier in the documentation, the prefix codes can 
  472.         be used in a variety of ways.  Let me set up a couple of examples 
  473.         to  demonstrate the versatility of prefix codes.   I will make  a 
  474.         couple of assumptions: that we are using a Hayes compatible modem 
  475.         and that we use three different long distance services.
  476.  
  477.              Here are the Prefix code strings currently stored:
  478.  
  479.              +) ,,,1234567
  480.              -) 1
  481.              !) 123-4567,,,1234567
  482.              @) 9,,
  483.              #) 999-9999,,,1234
  484.  
  485.              Let's  say we are using the type of service that  needs  the 
  486.         special  codes  at the beginning of the call.   We want  to  call 
  487.         number  12  in  the directory.  The correct  entry  to  the  dial 
  488.         subcommand  would  be "!12".   The resulting command sent to  the 
  489.         modem  would be:      
  490.  
  491.                   ATDT999-9999,,,1234319 266  8086<cr>.   
  492.  
  493.              The  commas  used in the prefix codes are assumed to be  the 
  494.         default   2  second delay used by most Hayes  compatible  modems.   
  495.         If  you use a long distance system,   you will have to experiment 
  496.         with how  many commas you need to make a successful call.
  497.  
  498.              In the second scenario,  the service in use needs a password 
  499.         at  the end of the long distance number.   So,  to dial number 12 
  500.         again,  use  the  command "12+".   This will send  the  following 
  501.         string to the modem:   
  502.  
  503.                   ATDT319 266 8086,,,1234567<cr>.
  504.  
  505.         Qmodem - Telecommunications Program Version 1.13  Page 13
  506.  
  507.  
  508.              And  last but not least,  a service that uses both types  of 
  509.         passwords.   To make things seem worse,  we are going to make the 
  510.         call at work using the PBX exchange.   This way,  I can make full 
  511.         use of three prefix codes at the same time.   Once again, we will 
  512.         dial  12  from  the  directory.   The dialing  command  would  be 
  513.         "@!12+".   
  514.  
  515.              The  string  sent to the modem would  be  as  follows:    
  516.                   
  517.                   ATDT9,999-9999,,,1234319 266 8086,,,,1234567
  518.  
  519.              Of  course,  this  string is 45 characters and  most  modems 
  520.         limit the input  to  40.    Be careful not to exceed the   limit!   
  521.         Take  out unnecessary spaces and commas to fit.
  522.  
  523.  
  524.              Manual dial
  525.  
  526.              With  manual  dial,  any combination of numbers and  letters 
  527.         (like  SmartModem(tm)  commands)  can be used.    Note  too  that  
  528.         the  dialing  prefixes  are valid in manual  dial   mode!   Also,  
  529.         after  using manual dial,   the Alt-Q redial will use the  number  
  530.         entered  for  the last manual dial.   This will most likely  save 
  531.         some  typing time  for  those of you that use   strange   dialing  
  532.         combinations.
  533.  
  534.              I  did  not put a limit on the number of characters  and  or 
  535.         letters  that could be entered in the manual dial.   It is up  to  
  536.         you  to determine how many characters that can be entered  before 
  537.         your modem will stop accepting data.
  538.  
  539.  
  540.              Next page
  541.  
  542.              Shows  the next page of the dialing directory unless page 10 
  543.         is already displayed.
  544.  
  545.  
  546.              Previous page
  547.  
  548.              Shows the previous page of the dialing directory unless page 
  549.         1 is already displayed.
  550.  
  551.  
  552.              Revise an entry
  553.  
  554.              The options side of the screen will clear and a prompt  will 
  555.         say "Number >".  Enter the number of the directory to be changed.  
  556.         Note  that the number to be changed does not have to be displayed 
  557.         for this to work.   Any number between 1 and 200 including 1  and 
  558.         200  will work fine.   
  559.  
  560.              A window will open up in the top middle of the screen.  Each 
  561.         part  of the entry number is displayed,  one part at a time,  and 
  562.         waits  for you to enter something.   If,  for  example,  you  are 
  563.  
  564.         Qmodem - Telecommunications Program Version 1.13  Page 14
  565.  
  566.  
  567.         updating  just the number for a bulletin board,  when the name is 
  568.         displayed, just press [RETURN] to skip to the next entry.  A null 
  569.         entry in the form of [RETURN] at any prompt in the revise  window 
  570.         will NOT change the previous data for that entry. In other words, 
  571.         you  won't have to retype all of the data every time you want  to 
  572.         make a small change.  
  573.  
  574.              When  the  revision is complete,  the window will  disappear  
  575.         and the directory will be updated on disk.  
  576.  
  577.  
  578.              Exit dialing directory
  579.  
  580.              This  will make the dialing directory window  disappear  and 
  581.         bring back the main screen just as it was before.
  582.  
  583.  
  584.              Alt-E Echo toggle
  585.  
  586.              This will turn on and off the Echo feature of Qmodem.   This 
  587.         is  used in case your keyboard strokes are echoed like "HHEELLOO" 
  588.         or not visible at all.
  589.  
  590.  
  591.              Alt-F Configuration menu
  592.  
  593.              The configuration menu has been moved to a separate  program 
  594.         called  QINSTALL.    Refer  to  Appendix  A  for  instruction  on 
  595.         Installations.
  596.  
  597.  
  598.              Alt-G  Graphics toggle
  599.  
  600.              This  is  used to toggle the display of ANSI  graphics.   It 
  601.         also controls  the  music to be heard if there is any.    To  use  
  602.         ANSI  graphics,   you  MUST have the ANSI.SYS in your  CONFIG.SYS 
  603.         file at boot-up time.   For further questions about ANSI,  please 
  604.         consult your DOS manual.
  605.  
  606.  
  607.              Alt-H  Hang up the Modem
  608.  
  609.              This  may  do one of two things depending on what  you  have 
  610.         entered in the configuration.   If you have entered "DTR" for the 
  611.         modem hangup string,  Qmodem will toggle the "DTR" signal and the 
  612.         connection will be dropped.   Otherwise,  it sends  out the Modem 
  613.         HangUp string.
  614.  
  615.         Qmodem - Telecommunications Program Version 1.13  Page 15
  616.  
  617.  
  618.              Alt-I  Information on Qmodem
  619.  
  620.              This  will  always tell you what version of Qmodem  you  are 
  621.         using,  The day it was compiled, and MY name, John Friel III.  If 
  622.         you  have  any problems with Qmodem,  please send me a card or  a 
  623.         letter and include this information.   This is the only way I can 
  624.         accurately solve the problem.
  625.  
  626.  
  627.              Alt-J  Function key menu
  628.  
  629.              This  will open up a rather large window with 5  parameters.  
  630.         Straight,  Shifted,  Ctrl,  Alt and Return to Qmodem.   Of course 
  631.         this is only good for the 10 function keys.   Select 1-4 to  view 
  632.         the current definitions for the key group.   If you want to alter 
  633.         any  of the keys,  enter the number to the left of the definition 
  634.         at  the  bottom.   
  635.  
  636.              There  are  Two  special character you  can  use.   The  "{" 
  637.         character will be substituted  by the [RETURN] key,  and the  "~" 
  638.         will cause a one-half second pause.  
  639.  
  640.  
  641.              Alt-L  Log new drive
  642.  
  643.              This  opens a small window and asks for the drive letter  to 
  644.         become  the default drive.   This works in conjunction  with  the 
  645.         Alt-W  and  downloads if no alternate drive was  defined.   Drive 
  646.         letters A through Z  are valid.
  647.  
  648.  
  649.              Alt-O  Change Sub-directories
  650.  
  651.              You  MUST  be  using DOS 2.0 or higher for this  command  to 
  652.         work.  This has to be one of the neater features of Qmodem.  With 
  653.         this command,  not one,  but two windows open up.   The long tall 
  654.         one  on the left of the screen is a listing of valid sub-dirs for 
  655.         the current directory you are in.  if you don't have any sub-dirs 
  656.         or  don't use them,  this would be blank.   the other main window 
  657.         lists  your  current path (if any) and waits for you to  enter  a 
  658.         CHDIR  command.   Any valid CD command can be entered  here,  not 
  659.         just what shows in the left column.  
  660.  
  661.              Examples:
  662.  
  663.              The current sub dir is C:\TURBO\QMODEM and I pressed Alt-O.
  664.              The left column would list  .
  665.                                          ..
  666.                                          TESTING
  667.                                          COLOSSUS
  668.  
  669.              Only 2 optional sub-dirs showed up.   To select TESTING, you 
  670.         only  need enter "testing" in the main window.   No need to  type 
  671.         the whole thing in again.   If you enter something wrong,  Qmodem 
  672.         will  give  you the message "Invalid CHDIR  command.  No  changes 
  673.  
  674.         Qmodem - Telecommunications Program Version 1.13  Page 16
  675.  
  676.  
  677.         made." and the windows will disappear.  On the other hand, Taking 
  678.         the same example as above,  if I wanted to switch to  my optional 
  679.         download  directory,  I could have typed in \COMM\DOWNLOAD to the 
  680.         prompt  and (provided the path was valid) I would then be  at  my 
  681.         download sub-dir.  Then I could do an Alt-W to check things out.
  682.  
  683.              Note too, that if you include the drive specifier with a new 
  684.         path command,  only the path on that drive is changed.   You will 
  685.         not change your current logged drive to that which was specified.  
  686.         This is important to remember,  The only way to change the logged 
  687.         drive is with the Alt-L command.
  688.  
  689.  
  690.              Alt-P  Communications parameters
  691.  
  692.              You  can  change your communication parameters  "on-the-fly" 
  693.         without  having  you  modem  hang  up.   Just  select  the  right 
  694.         parameters from the list shown. Pressing [RETURN] alone keeps the  
  695.         previous  setting and exits to Qmodem ready.  If one of the  list 
  696.         entries is selected,  the communication parameters   are  altered 
  697.         to reflect the new  choice  before  the window disappears.
  698.  
  699.  
  700.              Alt-Q  Redial last number
  701.  
  702.              The  last number   dialed  through  the  Alt-D  command  can  
  703.         be  repeatedly dialed until connection is made.    You MUST  have  
  704.         used  the   Alt-D first or you will get the message  "Nothing  to 
  705.         Redial".   
  706.              
  707.              Provided  there  is a number to redial,   Qmodem  shows  the 
  708.         current time redial was entered,  the current retry  number,  the 
  709.         time and the statistics about the number (who and what the number 
  710.         is).   Depending on how you have your modem set up,  specifically 
  711.         the S7 register in the Hayes,  the modem can time out and you get 
  712.         a "* Modem timed out or line busy *" message or the  Redial delay 
  713.         was hit and Qmodem cycles the redial itself.  
  714.  
  715.              Please keep the Redial delay above 45 seconds,  That way you 
  716.         are  assured  of getting at least a busy signal and  not  cycling 
  717.         just  as  the BBS is answering the phone.   
  718.  
  719.              While the window is open, you have Three commands: 
  720.                   
  721.                   C)ycle    cancels the current call in progress and goes 
  722.                             on to the next number.
  723.                   D)elete   cancels the current call and deletes it  from 
  724.                             the queue.   This means Redial will no longer 
  725.                             try the number.
  726.                   Any  KEY  will cancel the redial window and  bring  you                     
  727.                             back  to Qmodem's  terminal  mode.   Pressing 
  728.                             Alt-Q  again  will restart the dialing  cycle 
  729.                             again.
  730.  
  731.         Qmodem - Telecommunications Program Version 1.13  Page 17
  732.  
  733.  
  734.              Alt-R  DOS shell
  735.  
  736.              If  there  is  enough memory in your system and  a  copy  of 
  737.         COMMAND.COM is in the current path,   you  can temporarily   drop 
  738.         to DOS and return.   
  739.  
  740.              All  DOS commands are  then available,  should you  wish  to 
  741.         format a disk for example.  You can NOT  execute any program that 
  742.         attaches itself to DOS.    SideKick is a good example.  To return 
  743.         to Qmodem,  enter the EXIT command at the DOS prompt.   Remember,  
  744.         not  all  programs can be executed  in  this fashion,   Qmodem is 
  745.         not designed to be  a  DOS shell.
  746.  
  747.              Qmodem  will  try  to position you back to  where  you  were 
  748.         before  execution of Alt-R.   But because of stupid Drive  Letter 
  749.         limitation in DOS,  Qmodem may fail in this task.   Drive letters 
  750.         higher  than O:  are not recognized as valid and return an error, 
  751.         even  though  DOS 3.0 and up allow for drives  up  to  Z.   Turbo 
  752.         Pascal  mimics the error and will not let you log a disk with the 
  753.         ChDir  procedure higher than O:.   
  754.  
  755.              I have gotten around that to some extent,  but it is iffy at 
  756.         best.   Qmodem will print a "Warning" message on the screen  upon 
  757.         return if you were logged to a drive higher than O:.   If,  while 
  758.         you  were  in the DOS shell,  you changed drives and  the  logged 
  759.         drive previous to the Alt-R was higher than O:, Qmodem will say:
  760.              
  761.              * Warning: previous Drive\Path may be different.
  762.  
  763.              This  means  you  should check with Alt-O and Alt-L  to  see 
  764.         where you are.
  765.  
  766.  
  767.              Alt-S  Split screen mode
  768.  
  769.              The  screen  is  divided into two  partitions.   The  bottom 
  770.         partition  has  4 lines and the top has  20  lines.    I  thought 
  771.         there  might  be a need for something like this so here   it  is.   
  772.         Alt-S  is a toggle,  so hitting Alt-S again will drop you out  of  
  773.         split   screen   mode.    This is now  true  split  screen   mode 
  774.         complete  with  a  254  character  buffer.    Pressing  the  <CR> 
  775.         transmits  the buffer.   The keystrokes are kept track on on  the 
  776.         dividing  line.   The  character "{" can be used to substitute  a 
  777.         [CR] in the string.
  778.  
  779.  
  780.              Alt-T  Screen Dump
  781.  
  782.              This  copies  the  screen  in  its entirety  to  a  file  as 
  783.         specified in Qinstall.  The screen is APPENDed to the file with a 
  784.         Time and Date stamp.
  785.  
  786.         Qmodem - Telecommunications Program Version 1.13  Page 18
  787.  
  788.  
  789.         2.16      Alt-V  View a file
  790.  
  791.              This has several nice features wrapped into one.  It will do 
  792.         a  selective  directory  search  if wildcards  are  used  in  the 
  793.         filename.  Any number of these can occur until you either enter a 
  794.         valid  filename  or you press [RETURN] for an  invalid  filename.  
  795.         Both  exit back to Qmodem ready.   
  796.  
  797.              If  you  enter a valid filename,  you  are then  asked  what 
  798.         method  you  would like to view the  file.   Options  include  1) 
  799.         Qmodem  internal  method,   2) DOS TYPE command,  and   3)   your  
  800.         favorite List or Browse  utility.   The  last  two choices depend 
  801.         on how much free memory you have in your  machine.   Refer to the 
  802.         DOS  Shell command as the last 2 choices use a subset of the  DOS 
  803.         Shell.     If you select 3,  the  window clears and you are given 
  804.         a chance to read the  bottom line which states:   "Press  [SPACE] 
  805.         to pause,  [Esc] to exit.   Bytes queued  = X".    The later part  
  806.         has  to  do  with the amount of  data coming in  while  you   are 
  807.         viewing  a  file.    This will let you  know where  you are  with 
  808.         respect to communications.   
  809.  
  810.  
  811.              Alt-W  Disk directory with Xmit time
  812.  
  813.              This  is just like the DOS version of DIR /p.   Depending on 
  814.         where you are with respect to sub-directories,  all of the normal 
  815.         files are displayed with their respective attributes.  One of the 
  816.         enhancements  I  have made is to add the Transmit times  to  each 
  817.         file.   This Xmit time is is based on your current baud rate  set 
  818.         by  the Alt-P command.   Try changing the baud rate and doing  an 
  819.         Alt-W  and see the Xmit times change.   Don't you wish we all had 
  820.         9600 baud modems??  I do!  
  821.  
  822.              For those of you who have very lengthy directories,  you can 
  823.         press  the [Esc] key and Qmodem will skip the rest of  the  files 
  824.         and  show you the free space on the drive.   That's something DOS 
  825.         won't do.
  826.  
  827.  
  828.              Alt-X  Exiting Qmodem
  829.  
  830.              Pressing Alt-X will open yet another window (do you get  the 
  831.         feeling  that  I  like the use of the windows??) and ask  if  you 
  832.         really want to exit.   Of course,  this is just a safety valve in 
  833.         case  that  you really didn't intend to press Alt-X.   If you  do 
  834.         exit though,   no matter where you are in your hard disk,  Qmodem 
  835.         will   return you to where you started.   Qmodem will also  close 
  836.         your Capture File if it is open and restore you system to normal.
  837.              
  838.              Another command has been added to the Alt-X, entering an 'X' 
  839.         in response.  This will cause Qmodem to exit to DOS and leave the 
  840.         DTR line active.   If you were online with another computer,  you 
  841.         could  issue the Alt-X command,  enter an 'X',  format a disk  or 
  842.         some such thing, and re-invoke Qmodem and still be online.  
  843.  
  844.         Qmodem - Telecommunications Program Version 1.13  Page 19
  845.  
  846.  
  847.              Alt-Y  Delete a file
  848.  
  849.              Yes  Virginia,  there  is a file delete routine  in  Qmodem.  
  850.         Like  most file delete methods,  Qmodem asks for a valid filename 
  851.         and  checks to see if that file exist in the  current  directory.  
  852.         If it does, it asks you again if you really really want to delete 
  853.         this  file.   This  will be the last chance before you  might  do 
  854.         something  that can only be regretted later.   Please be  careful 
  855.         with this one!
  856.  
  857.  
  858.              Alt-Z  Xon / Xoff toggle
  859.  
  860.              This  will toggle the Xon / Xoff error checking  built  into 
  861.         Qmodem.   Xon  /  Xoff  is a very simple means  of  flow  control 
  862.         usually used by mini and mainframe computers.  With Xon / Xoff in 
  863.         the OFF mode,  a buffer overrun may occur in Qmodem on long ASCII 
  864.         transmissions.
  865.  
  866.         Qmodem - Telecommunications Program Version 1.13  Page 20
  867.  
  868.  
  869.              PgUp  Upload a file
  870.  
  871.              The  PgUp  key will open a window and ask you what  type  of 
  872.         transfer protocol you would like to use.  The choices are spelled 
  873.         right  out.    
  874.  
  875.                             1)  ASCII  
  876.                             2)  Xmodem  
  877.                             3)  Xmodem CRC   
  878.                             4)  Relaxed Xmodem  
  879.                             5)  IMP
  880.                             5)  Exit.   
  881.  
  882.              I  personally got tired of  adding  '=X' to all of  my  file 
  883.         transfers with  PC-Talk.     How many times have  you been  in  a  
  884.         hurry with an upload or a  download and  forgot  the '=X'?    Did 
  885.         it screw  things up?     Now  you know why I like  to put  things 
  886.         in menus. Let me explain a about the different transfer methods.
  887.  
  888.              ASCII  Transfer.   When  you select ASCII for  the  transfer 
  889.         method,  be  aware that line noise could make that  nice  looking 
  890.         documentation   look  funny  on the other  end.    Enough   said.   
  891.         The  options  that  immediately show up for the transfer  are  as 
  892.         follows:
  893.  
  894.                       'Enter  the  filename to Transmit >'  
  895.  
  896.             Answer this  with  the file you want to send.    Next you get 
  897.         a list of transfer methods.  1)  Prompted   2)  Time delay  3) No 
  898.         delay.    Each  one  has  its advantages and disadvantages  based 
  899.         upon  what kind of computer you are talking to.    Prompted  asks 
  900.         you  for the character to look for before sending a line of data.   
  901.         The prompt character cannot be a [SPACE].    Time delay asks  you 
  902.         to  enter  a  number in Hundredths of a  second  to  wait  before 
  903.         sending a line of data.    No delay is  a 'Blast that data' until 
  904.         it is all sent.  
  905.  
  906.              When ASCII mode is selected,  XON / XOFF protocol is also in 
  907.         effect.   This was added at a very late date to support the  mini 
  908.         and   mainframe  methods.    At  any time  during  the  transfer,  
  909.         pressing the PgUp key will  terminate the operation and bring you 
  910.         to the Qmodem ready mode.
  911.  
  912.              XMODEM  Transfer.    There are two methods currently used in 
  913.         public  domain to compute the validity of data sent  via  XMODEM.  
  914.         The first method is called checksum.  In checksum, the data block 
  915.         has  all  of the bytes added together and is then ANDed with  hex 
  916.         'FF'.   While  checksum is a pretty reliable method  of  insuring 
  917.         that  the  file  you sent is correct,  errors can  creep  in.   I 
  918.         believe the rate of error detection is somewhere near 99.6%.  
  919.  
  920.              The  second   method  of  error  checking  is  called   CRC,  
  921.         short  for Cylindrical  Redundancy  Checking.   This  method  has  
  922.         an  error detection rate of 99.9969%.    Unfortunately,  not  all 
  923.         BBS software has CRC transfer available.    Check with your local 
  924.  
  925.         Qmodem - Telecommunications Program Version 1.13  Page 21
  926.  
  927.  
  928.         board  to  find  out  which method should  be  used.   Qmodem  is 
  929.         intelligent  enough to figure  out  which is being sent when  you  
  930.         download,   so   if  you select the wrong one,  Qmodem will  make 
  931.         sure you get it right.
  932.  
  933.              First,  enter  a valid filename to  transmit.   Qmodem  will 
  934.         check  it out.   Qmodem will wait approximately 20 seconds for  a 
  935.         NAK to be received to start the transfer.   When the transfer  is 
  936.         started,  much  useful information is displayed.  Total blocks to 
  937.         send,  Transmit  time based on the current baud rate,  The  block 
  938.         being sent,  The current error count, and the time remaining till 
  939.         completion.  The time remaining till completion is based upon the 
  940.         number of blocks remaining at any given time.   
  941.  
  942.              Lets face it,  You will not be sending your data at the full 
  943.         baud  rate all of the time with XMODEM.   The time delay for  the 
  944.         NAK/ACK response slows this down.  Qmodem is fast though and this 
  945.         will certainly help the phone bills.  Here too, pressing the PgUp 
  946.         will terminate the transfer if so desired.
  947.  
  948.              Relaxed  Xmodem is nothing more than regular Xmodem,  except 
  949.         the timing has been relaxed by a factor of 10.   In other  words, 
  950.         it  takes  ten  times  longer  for  the  error  condition  to  be 
  951.         generated.   CompuServe users will appreciate this.   In fact, it 
  952.         was  because of the way CompuServe's computers handle (or fail to 
  953.         handle)  Xmodem that this was added.   Only use "Relaxed  Xmodem" 
  954.         when  talking  to  CompuServe  and  even  then  use  it  at  your 
  955.         discretion.   
  956.  
  957.              The last one is IMP.   This was completely thought up by  me 
  958.         and  should  NOT be confused with any other protocol  out  there.  
  959.         Again,  this  is  Unique to Qmodem v1.11 and up.   IMP  (Internal 
  960.         Modem  Protocol) is just that,  it relies on the availability  of 
  961.         modems  to  do  their own data  transmission  checking.   A  good 
  962.         example  would be the much talked about MNP from  Microcom.   MNP 
  963.         protocol  can be implemented on the hardware level usually inside 
  964.         your modem.  When two modems connect using MNP, the modems do all 
  965.         the  checking and retransmission necessary for a clean  exchange.  
  966.         Several  modem manufacturers like ARK (ARK  24K),  Novations  new 
  967.         2400, MultiTech's new 224 etc. have MNP built in.  
  968.  
  969.              But how does Qmodem take advantage of the MNP?   
  970.  
  971.              Simple,  it doesn't do anything!   Actually,  the modems are 
  972.         always verifying the data so there ARE no errors in the transfer.  
  973.         IMP  is a block oriented transfer method that uses no ACK or  NAK 
  974.         in the Xmodem sense.   Every block that goes out is guaranteed to 
  975.         get  there the way it was sent.   So,  IMP does not wait for  the 
  976.         other  computer to say if the block was correct or not,  that  is 
  977.         handled by the modems in REAL time.  
  978.  
  979.              But why does CTS have to be used?  
  980.  
  981.              In my experiences with MNP in the modems,  they use the  CTS 
  982.         signal  to  temporarily halt the flow to the modem when an  error 
  983.  
  984.         Qmodem - Telecommunications Program Version 1.13  Page 22
  985.  
  986.  
  987.         does occur.   If they didn't, Qmodem would overflow the modem and 
  988.         lost data would result, and ultimately, a bad file transfer.  
  989.  
  990.              What are the advantages of IMP?
  991.  
  992.              In  my  testing  (from Virginia to Iowa,  using  2  ARK  24K 
  993.         modems),  IMP  showed an impressive 115 blocks a minute  at  2400 
  994.         baud.   To put that in perspective, normal Xmodem (or Xmodem CRC) 
  995.         could only get about 88 blocks a minute at 2400 baud.   Remember, 
  996.         to use IMP, the modems MUST have an internal protocol. 
  997.  
  998.         Qmodem - Telecommunications Program Version 1.13  Page 23
  999.  
  1000.  
  1001.              PgDn  Download a file
  1002.  
  1003.              Here  too,  you get the menu asking for the type of transfer 
  1004.         you want to use.   Enter the appropriate response.   Let me  jump 
  1005.         right into the separate protocols.
  1006.  
  1007.              ASCII.   The  screen  will clear and you will be  told  that 
  1008.         pressing  the  PgDn key will terminate the transfer and save  the 
  1009.         file.   If you start the transfer, but no data has been received, 
  1010.         Qmodem will pretend as if no file was ever sent.   I don't  think 
  1011.         ASCII need much more explanation.
  1012.  
  1013.              XMODEM.   This  is  the new and improved method  of  keeping 
  1014.         track  of the transfer.   All types of errors are kept track  of.  
  1015.         When  the transfer starts,  the download window clears and a list 
  1016.         of  all of the errors are displayed.   Total blocks  received  is 
  1017.         displayed at the top.  The last line of the window shows the most 
  1018.         recent error message and at which block it occurred. 
  1019.  
  1020.              If you receive ten errors in a row,  Qmodem will cancel  the 
  1021.         transfer.  As soon as one block of data is received successfully, 
  1022.         the error count is set to zero.  Qmodem tries to recover from all 
  1023.         data  errors.   You  will note too the speed of which Qmodem  can 
  1024.         recover.    If you are having a problem,  give me a call.   I  am 
  1025.         willing  to  talk to you about any transfer problem that you  may 
  1026.         encounter.
  1027.              
  1028.              Again,   "Relaxed  Xmodem"  was  designed  for  talking   to 
  1029.         CompuServe.   See  the  description  under  File  Upload  in  the 
  1030.         previous section.
  1031.  
  1032.              For a description of IMP,  see the previous discussion under 
  1033.         Upload protocols.
  1034.  
  1035.              Now  a brief description of the errors that can be  detected 
  1036.         during  an  Xmodem  transfer.   Qmodem keeps track of  each  type 
  1037.         separately.  
  1038.  
  1039.              1)   Long block error  -  Caused usually by line  noise  
  1040.              and this creates extra characters in the transmission. 
  1041.  
  1042.              2)   Short  block error  -  if the line is weak or  you  
  1043.              are recovering from a previous error,  this can result. 
  1044.              It means that Qmodem did not receive enough  characters  
  1045.              to complete the data block.  
  1046.  
  1047.              3)    SOH error -  The first character of every  Xmodem  
  1048.              block  is  the SOH character (01  HEX).  If  the  first 
  1049.              character is not an SOH, Qmodem flags the block as bad. 
  1050.              Chances are that if the first byte is bad, so are a few 
  1051.              others  due  to the fact that line noise  usually  last 
  1052.              long enough to corrupt more that one byte.
  1053.  
  1054.              4)    Complement error -  The data block had two  bytes  
  1055.              in   the   header  to  hold the block  number  that  is   
  1056.  
  1057.         Qmodem - Telecommunications Program Version 1.13  Page 24
  1058.  
  1059.  
  1060.              being  transmitted/received.    The  second  of   these  
  1061.              two   is  the complement of the first (first  byte  XOR 
  1062.              255).   This ensures that Qmodem is getting the correct 
  1063.              block.
  1064.  
  1065.              5)    Block # error  -  This is usually caused by  line  
  1066.              noise  too.    The transmitting computer received a NAK 
  1067.              in place  of the  ACK Qmodem sent and resends the block 
  1068.              you just received successfully.    Essentially,  Qmodem  
  1069.              ignores the block  and sends another ACK.
  1070.  
  1071.              6)     Checksum/CRC  error -  Every block  of  data  in 
  1072.              Xmodem   is followed by either a Checksum byte or by  2 
  1073.              CRC  bytes.  CRC  is  a more accurate method  of  error 
  1074.              detection,   but  requires one more byte to be sent  in 
  1075.              every block.  If the Checksum or CRC is wrong,   Qmodem 
  1076.              sends a NAK and discards  the  data.  Again, line noise 
  1077.              is usually the culprit.
  1078.  
  1079.              This  might be an appropriate place to mention that  if  you 
  1080.         have "Call Waiting" with your phone service and someone calls you 
  1081.         while  you are doing an Upload/Download,  you stand a  chance  of 
  1082.         getting  errors.   This may even terminate the transfer depending 
  1083.         on the noise generated.  Be forewarned!
  1084.  
  1085.  
  1086.              Up Arrow  Scroll back the screen
  1087.  
  1088.              By  pressing the Up arrow,  you can scroll back through  the 
  1089.         previous lines of data that have come to the tube.    The   valid 
  1090.         keys  in  scroll  back mode are  
  1091.  
  1092.                   1) Up arrow    - go up one line  
  1093.                   2) Down arrow  - go down one line
  1094.                   3) PgUp        - go up one page
  1095.                   4) PgDn        - go down one page
  1096.                   5) Esc         - exit scroll back
  1097.  
  1098.              Pressing the [Esc] will exit scroll back mode.   This should 
  1099.         be  pretty much self  explanatory.    When you  reach the top  of 
  1100.         the scroll,  you get a message :
  1101.  
  1102.                                  * Top of Scroll 
  1103.  
  1104.         When you are at the bottom : 
  1105.  
  1106.                                * Bottom of Scroll
  1107.  
  1108.         Qmodem - Telecommunications Program Version 1.13  Page 25
  1109.  
  1110.  
  1111.                                A P P E N D I X   A
  1112.  
  1113.                      Qinstall - Qmodem Installation Program
  1114.                   
  1115.              Qinstall  takes the place of the Alt-F key combination  that 
  1116.         previous versions of Qmodem had.   More information was needed to 
  1117.         explain  the configuration than Qmodem could hold.   I have taken 
  1118.         the Alt-F screens and reworked for ease of setup.
  1119.  
  1120.              Qinstall will read any QMODEM.CNF file starting with  Qmodem 
  1121.         version  1.06.   You  may see garbage in some of the  data  entry 
  1122.         areas depending on how old your CNF file is.   It is important to 
  1123.         note; Qmodem v1.13 REQUIRES running Qinstall v1.13!  
  1124.  
  1125.              Lets jump right in and execute Qinstall.
  1126.  
  1127.              The first thing you will see is the familiar QMODEM logo and 
  1128.         a  list  of options.   These options are basically the same  ones 
  1129.         that  Qmodem used to have.   I recommend going through all Six so 
  1130.         you can make sure the data looks good.
  1131.  
  1132.              Select  option number One.   Qinstall will display  the  Six 
  1133.         Color  Options of Qmodem,  a Color Chart,  and the sample  Qmodem 
  1134.         display near the top.   Depending on the type of monitor card you 
  1135.         are  using,  the  edit  fields  are  either  inverse  video  (for 
  1136.         Monochrome)  or hi intensity White on Blue (for Color  Graphics).  
  1137.  
  1138.              Several  keys need to be explained;  as Qinstall contains  a 
  1139.         mini editor.  
  1140.  
  1141.                   Tab, Shift-Tab           Goes from field to field.
  1142.                   Up and Down Arrows            Same.
  1143.                   Left and Right Arrows    Moves by character.
  1144.                   Insert and ^V            Toggles INSERT mode.
  1145.                   Delete                   Deletes 1 character.
  1146.                   Esc                      Exit with no update
  1147.                   F10                      Exit and Update.
  1148.                   F1                       Context sensitive Help
  1149.              
  1150.              If you have any questions on any of the fields, press the F1 
  1151.         key and Qinstall will show you more information about that field.  
  1152.         If  you do not want to keep the changes made,  and would like  to 
  1153.         reset  them  to whatever they were when you entered  the  screen, 
  1154.         press  Esc.   To tell Qinstall to keep the changes you have made, 
  1155.         press F10.  Pressing F10 does Two things... a preliminary Edit on 
  1156.         the data,  and if it is good,  saves it.   If you have any  wrong 
  1157.         data,  Qinstall  will  warn  you and position the cursor  to  the 
  1158.         offending spot.  
  1159.  
  1160.              Qinstall has been created with the NEW USER in mind.  If you 
  1161.         are having trouble,  I would like to know about it.  Please write 
  1162.         me at the address given in Appendix D.
  1163.  
  1164.         Qmodem - Telecommunications Program Version 1.13  Page 26
  1165.  
  1166.  
  1167.                                A P P E N D I X   B
  1168.  
  1169.  
  1170.              TURBO Pascal Usage
  1171.  
  1172.              TURBO   Pascal  was  used  to  create  Qmodem  for   several 
  1173.         reasons.    The  language  is  easy  to  work  with.   It  allows 
  1174.         structured top-down programming and the  ability  to define  your 
  1175.         own types of variables.    Just as  a side   note,   Qmodem  does  
  1176.         not have a  single  GOTO  statement!  Another  advantage  is  the  
  1177.         creation  of  .COM  files  from  the compiler.   No  more  having  
  1178.         to load BASIC  and  then  run  your program.
  1179.              
  1180.              The   program editor is another big plus to the system.   It 
  1181.         emulates  the WordStar editor almost completely.    TURBO  Pascal 
  1182.         also  lets  you use all of the available memory in  your  system.  
  1183.         Programs can be larger than the available memory by the efficient 
  1184.         use of overlays.   I could go on and on about TURBO  Pascal.   By 
  1185.         the way,  I am not affiliated with Borland International,  just a 
  1186.         very happy customer.
  1187.  
  1188.         Qmodem - Telecommunications Program Version 1.13  Page 27
  1189.  
  1190.  
  1191.                                A P P E N D I X   C
  1192.  
  1193.  
  1194.              File structure of the phone directory
  1195.  
  1196.              The   following  is a copy from the source code  which shows 
  1197.         the file structure.
  1198.  
  1199.         Type
  1200.            check_bit        = (even, none, oddd);
  1201.            phone_type       = record
  1202.                                 name                   : string[25];
  1203.                                 number                 : string[14];
  1204.                                 speed, dbits, sbits    : integer;
  1205.                                 parity                 : check_bit;
  1206.                               end;
  1207.  
  1208.         Qmodem - Telecommunications Program Version 1.13  Page 28
  1209.  
  1210.  
  1211.                                A P P E N D I X   D
  1212.  
  1213.  
  1214.              Please consider the donation of $20.00.   Good software at a  
  1215.         good   price  is hard to come by.    We at  the  Forbin   Project 
  1216.         Inc.  support    the idea of "Shareware" and "Freeware" and  hope 
  1217.         all    of  you  do too.      It's because of you that I am   able  
  1218.         to  bring  you helpful programs like Qmodem.  Thanks again.
  1219.  
  1220.  
  1221.  
  1222.                              The Forbin Project Inc.
  1223.                              c/o John Friel III
  1224.                              715 Walnut Street
  1225.                              Cedar Falls, Iowa 50613
  1226.